home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 001-025 / scopedisk4 / scalc41 / vc.man < prev    next >
Text File  |  1995-03-18  |  12KB  |  399 lines
  1. (This documentation is from Fish Disk 53, and describes 'vc' an earlier
  2. version of this spreadsheet. They are very helpful, however, and for
  3. that reason are included here. sc 4.1 came without documentation) -eh
  4.  
  5.  
  6.      VC(1)                       UNIX 3.0                        VC(1)
  7.  
  8.  
  9.  
  10.      NAME
  11.           vc - spread sheet calculator ("visicalc-like")
  12.  
  13.      SYNOPSIS
  14.           vc [ file ]
  15.  
  16.  
  17.      DESCRIPTION
  18.           Vc is a calculator that is based on rectangular tables, in
  19.           much the same style as Visicalc or Lotus 123.  When it is
  20.           invoked it presents you with an empty table organised as
  21.           rows and columns of cells.  Each cell may have a label
  22.           string associated with it and an expression.  The expression
  23.           may be a constant or it may compute something based on other
  24.           entries.
  25.  
  26.           When vc is running, the screen is divided into four regions:
  27.           the top line is for entering commands, the second line is
  28.           for messages from vc, the third line and the first four
  29.           columns show the row and column numbers, and the rest of the
  30.           screen forms a window looking at the table.  vc has two
  31.           cursors: a cell cursor (indicated by a '<' on the screen)
  32.           and a character cursor (indicated by the terminals hardware
  33.           cursor).  The cell and character cursors are often the same.
  34.           They will differ when a long command is being typed on the
  35.           top line.
  36.  
  37.           Commands which use the terminal's control key will work when
  38.           either a long command is being typed or in "normal" mode.
  39.  
  40.           The cursor control commands and the row, column commands can
  41.           be prefixed by a numeric argument indicating how many times
  42.           the command is to be executed.  "^U" can be used before the
  43.           number if the cursor movement is to take place while a
  44.           command is being typed into the command line.
  45.  
  46.           Cursor control commands:
  47.  
  48.  
  49.           ^N   Move the cell cursor to the next row.
  50.  
  51.  
  52.           ^P   Move the cell cursor to the previous row.
  53.  
  54.  
  55.           ^F   Move the cell cursor forward one column.
  56.  
  57.  
  58.           ^B   Move the cell cursor backward one column.
  59.  
  60.  
  61.           ^H   Backspace one character.
  62.  
  63.  
  64.  
  65.      Page 1                                           (printed 1/5/87)
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.      VC(1)                       UNIX 3.0                        VC(1)
  73.  
  74.  
  75.  
  76.           h, j, k, l
  77.                Alternate cursor controls (left, down, up, right).
  78.  
  79.  
  80.           0    Move the cell cursor to column 0 of the current row.
  81.  
  82.  
  83.           $    Move the cell cursor to the last valid column in the
  84.                current row.
  85.  
  86.  
  87.           Cell entry and editing commands:
  88.  
  89.  
  90.           =    Prompts for an expression which will be evaluated
  91.                dynamically to produce a value for the cell pointed at
  92.                by the cell cursor.  This may be used in conjunction
  93.                with ^V to make one entries value be dependent on
  94.                anothers.
  95.  
  96.  
  97.           "    Enter a label for the current cell.
  98.  
  99.  
  100.           <    Enter a label that will be flushed left against the
  101.                left edge of the cell.
  102.  
  103.  
  104.           >    Enter a label that will be flushed right against the
  105.                right edge of the cell.
  106.  
  107.  
  108.           x    Clears the current cell.
  109.  
  110.  
  111.           e    Edit the value associated with the current cell.  This
  112.                is identical to '=' except that the command line starts
  113.                out containing the old value or expression associated
  114.                with the cell.
  115.  
  116.  
  117.           E    Edit the string associated with the current cell.  This
  118.                is the same as either "leftstring", "rightstring", or
  119.                "label", with the additional fact that the command line
  120.                starts out with the old string.
  121.  
  122.  
  123.           m    Mark a cell to be used as the source for the copy
  124.                command.
  125.  
  126.  
  127.           c    Copy the last marked cell to the current cell, updating
  128.  
  129.  
  130.  
  131.      Page 2                                           (printed 1/5/87)
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.      VC(1)                       UNIX 3.0                        VC(1)
  139.  
  140.  
  141.  
  142.                the row and column references.
  143.  
  144.  
  145.           ^T   Toggle cell display.  The current cell's contents are
  146.                displayed in line one when no command being entered or
  147.                edited.  ^T turns the display on or off.
  148.  
  149.  
  150.           File operations
  151.  
  152.  
  153.           G    Get a new database from a file.
  154.  
  155.  
  156.           P    Put the current database into a file.
  157.  
  158.  
  159.           W    Write a listing of the current database in a form that
  160.                matches its appearance on the screen.  This differs
  161.                from the "put" command in that "put"s files are
  162.                intended to be reloaded with "get", while "write"
  163.                produces a file for people to look at.
  164.  
  165.  
  166.           T    Write a listing of the current database to a file, but
  167.                put ":"s between each field.  This  is useful for
  168.                tables that will be further formatted by the tbl
  169.                preprocessor of nroff.
  170.  
  171.  
  172.           M    Merges the database from the named file into the
  173.                current database.  Values, expressions and names
  174.                defined in the named file are written into the current
  175.                file, overwriting the existing entries at those
  176.                locations.
  177.  
  178.  
  179.           Row and Column operations.  Members of this class of
  180.           commands can be used on either rows or columns.  The second
  181.           letter of the command is either a column designator (one of
  182.           the characters c, j, k, ^N, ^p) or a row designator (one of
  183.           r, l, h, ^B, ^F).  Commands which move or copy cells also
  184.           modify the variable references in affected cell expressions.
  185.           Variable references may be frozen by using the "fixed"
  186.           operator.
  187.  
  188.  
  189.           ar, ac
  190.                Creates a new row (column) immediately following the
  191.                current row (column).  It is initialized to be a copy
  192.                of the current one.
  193.  
  194.  
  195.  
  196.  
  197.      Page 3                                           (printed 1/5/87)
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.      VC(1)                       UNIX 3.0                        VC(1)
  205.  
  206.  
  207.  
  208.           dr, dc
  209.                Delete this row (column).
  210.  
  211.  
  212.           pr, pc, pm
  213.                Pull deleted rows (columns) back into the spread sheet.
  214.                The last deleted set of cells is put back into the
  215.                spread sheet at the current location.  Pr inserts
  216.                enough rows to hold the data.  Pc inserts enough
  217.                columns to hold the data.  Pm (merge) does not insert
  218.                rows or columns, but overwrites the cells beginning at
  219.                the current cursor location.
  220.  
  221.  
  222.           ir, ic
  223.                Insert a new row (column) by moving the row (column)
  224.                containing the cell cursor, and all following, down
  225.                (right) one.  The new position will be empty.
  226.  
  227.  
  228.           zr, zc
  229.                Hide ("zap") the current row (column).  This keeps a
  230.                row or column from being displayed but keeps it in the
  231.                data base.
  232.  
  233.  
  234.           vr, vc
  235.                Removes expressions from the affected rows (columns),
  236.                leaving only the values which were in the cells before
  237.                the command was executed.
  238.  
  239.  
  240.           sr, sc
  241.                Show hidden rows (columns).  Type in a range of rows or
  242.                columns to be revealed.  The command default is the
  243.                first range of rows or columns currently hidden.
  244.  
  245.  
  246.           f    Sets the output format to be used for printing the
  247.                numbers in each cell in the current column.  Type in
  248.                two numbers which will be the width in characters of a
  249.                column and the number of digits which will follow the
  250.                decimal point.  Note that this command has only a
  251.                column version and does have a second letter.
  252.  
  253.  
  254.           Miscellaneous commands:
  255.  
  256.  
  257.           ^C   Exit from vc.  If you were editing a named file, and
  258.                you modified it, then it will ask about saving before
  259.                exiting.
  260.  
  261.  
  262.  
  263.      Page 4                                           (printed 1/5/87)
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.      VC(1)                       UNIX 3.0                        VC(1)
  271.  
  272.  
  273.  
  274.           q    Alternate exit command.
  275.  
  276.  
  277.           ?    Types a brief helpful message.
  278.  
  279.  
  280.           /    Copy a region to the area specified by the current
  281.                cell.
  282.  
  283.  
  284.           ^G or ESC
  285.                Abort the current long command.
  286.  
  287.  
  288.           ^R   Redraw the screen.
  289.  
  290.  
  291.           ^V   Types, in the long command line, the name of the cell
  292.                being pointed at by the cell cursor.  This is used when
  293.                typing in expressions to refer to entries in the table.
  294.  
  295.  
  296.           ^E   Types, in the long command line, the expression of the
  297.                cell being pointed at by the cell cursor.
  298.  
  299.  
  300.           ^A   Types, in the long command line, the value of the cell
  301.                being pointed at by the cell cursor.
  302.  
  303.  
  304.           Expressions that are used with the '=' and 'e' commands have
  305.           a fairly conventional syntax.  Terms may be variable names
  306.           (from the ^V command), parenthesised expressions, negated
  307.           terms, and constants. Rectangular regions of the screen may
  308.           be operated upon with '@' functions such as sum (@sum),
  309.           average (@avg) and product (@prod).  Terms may be combined
  310.           using many binary operators.  Their precedences (from
  311.           highest to lowest) are: *,/; +,-; <,=,>,<=,>=; &; |; ?.
  312.  
  313.  
  314.           e+e            Addition.
  315.  
  316.  
  317.           e-e            Subtraction.
  318.  
  319.  
  320.           e*e            Multiplication.
  321.  
  322.  
  323.           e/e            Division.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.      Page 5                                           (printed 1/5/87)
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.      VC(1)                       UNIX 3.0                        VC(1)
  337.  
  338.  
  339.  
  340.           @sum(v:v)      Sum all valid (nonblank) entries in the
  341.                          region whose two corners are defined by the
  342.                          two variable (cell) names given.
  343.  
  344.  
  345.           @avg(v:v)      Average all valid (nonblank) entries in the
  346.                          region whose two corners are defined by the
  347.                          two variable (cell) names given.
  348.  
  349.  
  350.           @prod(v:v)     Multiply together all valid (nonblank)
  351.                          entries in the region whose two corners are
  352.                          defined by the two variable (cell) names
  353.                          given.
  354.  
  355.  
  356.           e?e:e          Conditional: If the first expression is true
  357.                          then the value of the second is returned,
  358.                          otherwise the value of the third is.
  359.  
  360.  
  361.           <,=,>,<=,>=    Relationals: true iff the indicated relation
  362.                          holds.
  363.  
  364.  
  365.           &,|            Boolean connectives.
  366.  
  367.  
  368.           fixed          To make a variable not change automatically
  369.                          when a cell moves, put the word fixed in
  370.                          front of the reference.  I.e.  B1*fixed C3
  371.  
  372.  
  373.  
  374.      SEE ALSO
  375.           bc(1), dc(1)
  376.  
  377.  
  378.      BUGS
  379.           Expression reevaluation is done in the same top-to-bottom,
  380.           left-to-right manner as is done in other spread sheet
  381.           calculators.  This is silly.  A proper following of the
  382.           dependency graph with (perhaps) recourse to relaxation
  383.           should be implemented.
  384.  
  385.           At most 200 rows and 40 columns.
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.      Page 6                                           (printed 1/5/87)
  396.  
  397.  
  398.  
  399.